package com.ruoyi.app.service;

import java.util.List;
import com.ruoyi.app.domain.AppMediumActivityUser;

/**
 * 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）Service接口
 * 
 * @author ruoyi
 * @date 2025-11-04
 */
public interface IAppMediumActivityUserService 
{
    /**
     * 查询活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     * 
     * @param activityUserId 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）主键
     * @return 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     */
    public AppMediumActivityUser selectAppMediumActivityUserByActivityUserId(Long activityUserId);

    /**
     * 查询活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）列表
     * 
     * @param appMediumActivityUser 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     * @return 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）集合
     */
    public List<AppMediumActivityUser> selectAppMediumActivityUserList(AppMediumActivityUser appMediumActivityUser);

    /**
     * 新增活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     * 
     * @param appMediumActivityUser 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     * @return 结果
     */
    public int insertAppMediumActivityUser(AppMediumActivityUser appMediumActivityUser);

    /**
     * 修改活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     * 
     * @param appMediumActivityUser 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     * @return 结果
     */
    public int updateAppMediumActivityUser(AppMediumActivityUser appMediumActivityUser);
    /**
     * 统计指定活动的报名人数
     * @param activityId 活动ID
     * @return 报名人数
     */
    int countEnrolledUsersByActivityId(Long activityId);
    /**
     * 批量删除活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）
     * 
     * @param activityUserIds 需要删除的活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）主键集合
     * @return 结果
     */
    public int deleteAppMediumActivityUserByActivityUserIds(Long[] activityUserIds);

    /**
     * 删除活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）信息
     * 
     * @param activityUserId 活动与用户的关联关系（无物理外键，通过业务逻辑维护关联）主键
     * @return 结果
     */
    public int deleteAppMediumActivityUserByActivityUserId(Long activityUserId);

    /**
     * 用户报名活动
     * @param userId 用户ID
     * @param activityId 活动ID
     * @return 操作结果（1=新增，2=更新）
     */
    int enrollActivity(Long userId, Long activityId);

    /**
     * 用户收藏活动
     * @param userId 用户ID
     * @param activityId 活动ID
     * @return 操作结果（1=新增，2=更新）
     */
    int collectActivity(Long userId, Long activityId);
}
